home *** CD-ROM | disk | FTP | other *** search
/ Aminet 43 / Aminet 43 (2001)(GTI - Schatztruhe)[!][Jun 2001].iso / Aminet / dev / c / amigastlport.readme < prev    next >
Text File  |  2001-05-03  |  6KB  |  132 lines
  1. Short:    Standard Template Library for StormC v4
  2. Uploader: Raymond Zarling (rayz@cs.csustan.edu)
  3. Type:     dev/c
  4.  
  5. Since it took me several days to configure a port of the Standard
  6. Template Library (STL) for StormC version 4, I thought I'd publish
  7. what I came up with.
  8.  
  9. The STL is a terrific set of algorithms and data structures which
  10. enable a C++ programmer to more quickly implement programs.  Although
  11. the STL is part of the most recent C++ standard, to date only the
  12. Gnu compiler gcc implements it on the Amiga.
  13.  
  14. The latest release of StormC from Haage and Partner (www.haage-partner.com)
  15. does not include the STL as shipped, but is a sufficiently powerful and
  16. complete compiler that it can be augmented with an STL obtained elsewhere.
  17. This file describes how you may do that.
  18.  
  19. This project is based on the code provided at www.stlport.org, a
  20. freely redistributable port of the STL which works on a wide variety
  21. of computers and compilers.  Until now, nobody had evidently customized
  22. the port for the Amiga, however.  When you go to the stlport web site
  23. they ask you to register so they know who is using their code.  In order
  24. not to subvert their procedure, this archive contains only the Amiga-
  25. specific configuration files (and one header file that needed to be
  26. modified for the Amiga).  You will need to download the bulk of the
  27. STL port from stlport's web site.
  28.  
  29.  
  30. --STL References--
  31.  
  32. For more information on the STL see:
  33.  
  34. http://www.sgi.com/Technology/STL
  35. Austern, Matthew H., _Generic Programming and the STL_, Addison Wesley 1999.
  36. Robson, Robert, _Using the STL_, Springer Verlag (2nd ed, 2000).
  37.  
  38.  
  39. --Procedure To Install the STL--
  40.  
  41. Download StlPort version 4 (the tar gnuzipped archive format) from
  42. www.stlport.org and uncompress and unpack it.  This will create a
  43. directory STLport-4.0 which contains several subdirectories.  The
  44. only subdirectory that is really needed to get things working is
  45. stlport, though you may find some of the others interesting as well.
  46.  
  47. Copy the stlport directory to StormC:.  Do whatever you wish with the
  48. other directories from the archive.
  49.  
  50. Replace the following files in StormC:stlport with the ones in this archive:
  51.  
  52.     stl_user_config.h
  53.     stdexcept
  54.     config/stl_stormgcc.h (new file)
  55.     config/stlcomp.h
  56.     stl/_site_config.h
  57.  
  58.  
  59. --Using the STL--
  60.  
  61. For any project which will use the STL, add StormC:stlport as the first
  62. include path (before StormC:include) in the Environment Settings list of
  63. include paths.  In your program, include whichever pieces of the STL your
  64. code requires, e.g. #include <string> or #include <algorithm>.  Under
  65. Compiler Settings, you will of course need to use C++ as your language.
  66. Some parts of the STL use exceptions, so you may need to enable them.
  67.  
  68. In addition to the STL component, you also get the new-style system
  69. header files whose names do not end in .h; e.g. <iostream> instead of
  70. <iostream.h> and <cctype> instead of <ctype.h>.  Technically, if you use
  71. these new-style headers, you are also supposed to enable the std::
  72. namespace with the line "using namespace std;".  With the StormC compiler
  73. (and with gcc) this line is currently optional, although for forward
  74. compatability it is probably wise to include it.
  75.  
  76.  
  77. That's it!  Enjoy!
  78.  
  79.  
  80. --Disclaimer--
  81.  
  82. I have tested the STL configuration in this archive fairly broadly, including
  83. string, list, vector, map, iterator, input_ and output_iterator, valarray,
  84. exception, find, sort, rel_op, ptr_fun, etc. on small and large programs,
  85. including several feature interactions.  It has not however been tested
  86. deeply--to date I have only tried a few dozen programs altogether, and with
  87. only a few compiler settings.  It is entirely possible I have not yet gotten
  88. all of the dozens of STL settings quite right.  Most of what I did was found
  89. by trial and error; it could be that more trials will find more errors...
  90.  
  91. The stlport distribution includes some non-standard extensions; I have
  92. disabled those in my configuration files because I want to keep my code
  93. portable.  I have also not tried features like the STL debug modes or
  94. multiple threads.
  95.  
  96. If your usage leads you to make futher configuration changes, please let
  97. me know what problem occurred and how you resolved it so I may consider
  98. it for a future release.
  99.  
  100.  
  101. --Original STLport Copyright Notice--
  102.  
  103. From the www.stlport.org web site, the port available there is
  104.  
  105.     Copyright © 1999,2000 Boris Fomitchev
  106.  
  107.     This material is provided "as is", with absolutely no warranty
  108.     expressed or implied. Any use is at your own risk. Permission to
  109.     use or copy this software for any purpose is hereby granted
  110.     without fee, provided the above notices are retained on all
  111.     copies. Permission to modify the code and to distribute modified
  112.     code is granted, provided the above notices are retained, and a
  113.     notice that the code was modified is included with the above
  114.     copyright notice.
  115.  
  116. This modification is distributed under the above license, and any use or
  117. redistribution is governed by the same limitations, freedoms and restrictions.
  118.  
  119.  
  120. ============================= Archive contents =============================
  121.  
  122. Original  Packed Ratio    Date     Time    Name
  123. -------- ------- ----- --------- --------  -------------
  124.     4988    2400 51.8% 22-Feb-01 16:22:00  amiga_stlport.readme
  125.     3873    1568 59.5% 16-Feb-01 14:41:46 +stlcomp.h
  126.     4880    1757 63.9% 19-Feb-01 19:11:00 +stl_stormgcc.h
  127.     3703    1269 65.7% 19-Feb-01 17:00:16 +stdexcept
  128.     5885    2145 63.5% 19-Feb-01 16:12:42 +_site_config.h
  129.     8711    3532 59.4% 19-Feb-01 19:05:54 +stl_user_config.h
  130. -------- ------- ----- --------- --------
  131.    32040   12671 60.4% 06-Mar-101 01:25:18   6 files
  132.